home *** CD-ROM | disk | FTP | other *** search
/ LG Super CD / LG Super CD.iso / apps / midp-man(pac man) / midiconverter / gnmidfmt.doc < prev    next >
Encoding:
Text File  |  2002-05-12  |  14.1 KB  |  328 lines
  1.         ******************************
  2.                         gnmidfmt 1.08
  3.               MIDI Format Converter for Windows 95/ME/2000
  4.             Shareware    (English and German)
  5.     
  6.               by Guenter Nagler 
  7.                 1999 
  8.           (info@gnmidi.com)
  9.         ******************************
  10.  
  11. [1] BACKGROUND
  12. There are 3 midi formats inside standard midi file format (.mid).
  13. In many cases the midi file format must be converted to use a MIDI file
  14. on certain devices or for certain application.
  15. There are free MIDI commandline utilities for DOS available but most users
  16. don't like commandline utilities or DOS environment.
  17. Therefore I wrote earlier GNMIDI and since some users don't require the
  18. many operations that GNMIDI supports, I wrote this program that cares
  19. about MIDI file format only. It can read also RIFF Midi (.rmi) and maybe other
  20. formats that contain standard midi file inside the file.
  21.  
  22. This program should be cheaper than GNMIDI Shareware, because of the smaller
  23. number of available functions. GNMIDI users have the advantage that they
  24. can use this program for free with their GNMIDI license.
  25.  
  26. This program converts following formats:
  27.    Standard MIDI file format 0,1,2 into MIDI format 0,1,2
  28.    .rmi RIFF MIDI file into MIDI format 0,1,2
  29. It can check file format of midi files if wanted.
  30.  
  31. The demo version allows converting single MIDI files and a selection of 
  32. max. 2 midi files from a directory at once. The full registered version
  33. removes the waiting dialogs and lets convert many files from a directory 
  34. at once.
  35.  
  36. [2] FILES DESCRIPTION
  37.  
  38. GNMIDFMT.EXE.........converter program (multilingual: English and German)
  39. GNMIDFMT.DOC.........this file, showing usage of GNMIDFMT.EXE
  40. README.TXT.........how to register
  41. FORMAT.DOC.........help to midi file formats (how they are organized)
  42. only GNMIDFMT.EXE is required to run program
  43.  
  44. Sources of the Windows program itself are not available. 
  45. If you don't want to register then you can learn using DOS commandline tools
  46. in Windows DOS box, there are some utilities usable free for 
  47. noncommercial use on our WWW page.
  48.  
  49. [3] COPYRIGHT
  50.  
  51. GNMIDFMT (c) 1999 was created by Guenter Nagler.
  52.  
  53. GNMIDFMT 1.0 and later is not free it is Shareware (see [8]).
  54. You can use it for 5 days to test it and then must 
  55. register (see [8] and [9]) if use it further or delete the program.
  56. Price might change anytime. Download newest demo version to see price.
  57.  
  58. You can give GNMIDFMT 1.0 and later versions to your friends, on a 
  59. shareware cdrom, www page, bbs etc. 
  60. but must include whole unmodified gnmidfmt.zip (including this .doc, program, 
  61. picture, readme).
  62.  
  63. Personal license files must not be distributed (they are never
  64. included in a gnmidfmt.zip). Users personal data
  65. is included readable in personal license files, so any illegal
  66. distribution of these files uncover the copyright violation with
  67. consequences by law.
  68.  
  69. [4] DISCLAIMER
  70.  
  71. GNMIDFMT was designed to handle 100% compatible standard MIDI files.
  72. So I give no guarantees of the results, especially with non 100% 
  73. compatible MIDI files.
  74. If you find a MIDI file that you think to be 100% compatible MIDI
  75. that is not correctly converted, please send a sample file to 
  76. info@gnmidi.com
  77.  
  78. Use GNMIDFMT at your own risk.  Anything you do with GNMIDFMT is your
  79. responsibility, and not the author's.  Any damage caused to any person,
  80. computer, software, hardware, company, or business by running GNMIDFMT 
  81. is your responsibility, and the author will not be liable.
  82.  
  83. If you don't understand these terms, or are not sure of something, or
  84. are afraid something bad might come of using GNMIDFMT, don't  use  it!
  85. You are here forewarned.
  86.  
  87. If you use stolen software then you (as thief) are responsible for any
  88. aggressive actions of the program!
  89.  
  90. The demo behaves identical to full version, with exception of uncomfortable 
  91. warnings. The demo shows you all features of full version and it would be
  92. silly of you to take any risk of software piracy, only to compare demo with
  93. full version and find no differences. If you have questions to differences
  94. between full version and demo at certain points, then simply ask the author.
  95.  
  96. [5] INSTALLATION 
  97.  
  98.   This program runs under MS Windows (tm) versions Win95, WinME or Win2000.
  99.   It does not run under Windows 3.x and older.
  100.   It is currently not tested with other Windows versions like Win98, NT, XP,
  101.   therefore we cannot guarantee that it works with them. If you need to 
  102.   use this software with those unsupported systems please try demo self and
  103.   register with knowledge that we maybe cannot fix system depending software 
  104.   problems.
  105.  
  106.   Move GNMIDFMT.EXE in a directory that is in your Windows path.
  107.  
  108.   Start it with Explorer by clicking on the GNMIDFMT.EXE program item.
  109.  
  110.   For future use you can add the program item to one of your desktop 
  111.   groups (or create a new one), use Explorer or Program Manager to create
  112.   a shortcut.
  113.  
  114. When you registered then install your personal license file:
  115.   Unzip the file with your personal data (that I send you when I get 
  116.   your correctly filled registration form and paid price) into directory
  117.   where GNMIDFMT.EXE is installed.
  118.   This disables the shareware reminder dialogs and program status bar 
  119.   immediately tells that you are registered. 
  120.  
  121. GNMIDI registered users can install their GNMIDI license here.
  122.  
  123. [6] USAGE
  124.  
  125. 1. Open a single MIDI file (.mid, .kar, .rmi ...)
  126. Use File/Open and choose the midi file with the open file dialog.
  127. Load the file with OK.
  128. GNMIDFMT reads the file header, if option Format/check midi file format is checked
  129. then reads the whole midi file and checks validity of the file.
  130. A new window opens and shows the filename and the file format number 0-2.
  131. In case of a file format error it shows "error" instead of file format.
  132.  
  133. 2. Open a directory of MIDI files (Browse)
  134. Use File/Browse and choose one file from the directory.
  135. GNMIDFMT loads the directory listing of the directory and reads file format of
  136. each file. Files that are not MIDI files are ignored. MIDI Files with error
  137. are marked with "error". The operation can take long if many midi files are
  138. inside a directory. Subdirectories are ignored.
  139. A new window is opened and shows the list of MIDI files with their format 
  140. information.
  141. The program remembers the last chosen file path and suggests this again.
  142.  
  143. 3. Option for checking MIDI files at Open
  144. The menu File/check midi file format  can be checked or unchecked.
  145. Checked:  check each midi file for validity, this is surely slower because
  146. whole midi files must be read, invalid files are marked with "error" in the list.
  147. Unchecked: midi file format is not checked, quicker because only midi header is
  148. read.  It is not sure that file can really be converted (can't if it is invalid).
  149.  
  150. 4. Sort the entries in the listbox
  151. The two buttons above the listbox are used to sort the list entries by 
  152. filename (full path) or by file format.
  153. Sorting can take long time if many files are in the listbox.
  154.  
  155. 5. Select MIDI files to convert
  156. You can select single files or multiple files from the window with the listbox.
  157. The same mouse selection as in Explorer can be used to select files from the list:
  158.   * click with left mouse button on an entry: 
  159.     select the entry and unselect all others
  160.   * press left mouse button on an entry, move mouse, release mouse button on an entry:
  161.       select a range of entries and unselect all others
  162.   * same as above but with <ctrl> or <strg> key pressed:
  163.          select entries but keeps others selected, unselects if selecting entry again
  164. After each selection change the toolbar buttons 0,1,2 are selected or unselected
  165. depending if one of the selected files can be converted to this format.
  166. Sort files by format if you want select files of certain file format.
  167.  
  168. 6. Convert selected files to a certain format
  169. After selecting click on one of the toolbar buttons 0,1,2 to convert the 
  170. selected files to the chosen format.
  171.  
  172. If files have identical format then they are ignored (old format equal to new format).
  173. If files contain errors then they are ignored ("error").
  174.  
  175. Conversion from format 0 and 1 to 0,1, or 2 make a backup of the original file 
  176. (.bak) and replace the original file by the conversion result.
  177. If original file is not writable then the operation fails, also if it is  
  178. impossible to create a backup file.
  179.  
  180. Conversion from format 2 to 0 or 1 will ask for a prefix for new files.
  181. Since format 2 files usually contain more songs, the program needs
  182. name for new files. It suggests identical name as original and will add
  183. suffix ...1.mid ...2.mid etc. to the converted files. 
  184. E.g. converting c:\2format.mid to format 1 will ask if prefix for new
  185. files should be c:\2format and if accepting this then will generate new files
  186. c:\2format1.mid, c:\2format2.mid, ... (the count depends on the number of midi 
  187. songs inside the original).
  188.  
  189. After conversion the new files are added to the list and old entries format are 
  190. updated.
  191. Invalid files are not convertable.
  192.  
  193. 7. Get more information about MIDI file formats
  194. Choose menu Help/about midi files  to display text document format.doc in
  195. a text viewer (usually notepad). This document explains detailed the
  196. formats, how they work, for what they are used, what conversion does.
  197.  
  198. 8. Get program help
  199. Press F1 or choose menu Help/Help to display text document gnmidfmt.doc (this document)
  200. in a text viewer (usually notepad). This document explains usage of program.
  201.  
  202. 9. Get program version 
  203. Choose menu Help/About GNMIDFMT to display the copyright information and
  204. version of current program. Look from time to time at our WWW page if 
  205. an update is available.
  206.  
  207. 10. Get registration information
  208. Choose menu Help/Register information to display text document readme.txt 
  209. in a text viewer (usually notepad). This document contains 
  210. price, payment methods,    registration form, our address.
  211. If you are registering then download newest demo version to get the current 
  212. valid registration information (price, address ...).
  213. You can also ask us by email if something is unclear.
  214.  
  215. 11. Turn off MIDI compression for older MIDI keyboards that don't support compression
  216. Open gnmidfmt.ini in Windows folder (often c:\Windows) with notepad text 
  217. editor and add following setting to section [Settings]
  218.  
  219. [Settings]
  220. MidiAutoCompression=0
  221.  
  222. Delete the line that contains MidiAutoCompression field if you want to 
  223. compress MIDI files during format conversion.
  224.  
  225.  
  226.  
  227. [7] SUGGESTIONS / COMMENTS / BUG REPORTS / QUESTIONS
  228.  
  229.          WWW:    http://www.gnmidi.com
  230.           contains all my dos/windows/unix MIDI programs
  231.              EMAIL:  info@gnmidi.com
  232.                  support@gnmidi.com
  233.                  abuse@gnmidi.com
  234.     Support only for registered users.
  235.     Bug reports, comments, suggestions also from testers welcome.
  236.  
  237. [8] SHAREWARE
  238.  
  239. GNMIDFMT 1.0 and later is not freeware it is shareware.
  240. Registration costs since 1. October 1999  12 US$ or 10 Euro  
  241. (price is valid till 30.12.2002). Old price is not valid anymore.
  242. Orders can be done online at www.regsoft.com (Product ID is 16880, 
  243. Product name is GNMIDFMT). If ordering directly
  244. from GN Midi Solutions you must send the money and a correctly filled
  245. order form (see readme.txt). The address must be correct else we cannot
  246. deliver the license. For wrong address you have to pay extra shipping costs 
  247. (2 US$) that we send disk at a second try. It is not possible to get
  248. license only by email. For oversea (outside Europe we can send a time
  249. limited license valid for the time of disk delivery after payment is 
  250. proved).
  251. After you get floppy disk you get a license that is valid for GNMIDFMT 1.0 
  252. and minor upgrades 1.01-1.99
  253. (download see [7]). It is not possible to get license for a certain 
  254. minor version or an old version, only a major version. This is your
  255. benefit, since this includes fixing problems that might be found and
  256. advancing the product with new features and comfortabilities.
  257.  
  258. If you purchased a GNMIDI registration you can use this 
  259. program for free, install GNMIDI license.
  260.  
  261. Tell software abuse or copyright violations or unlegitimated sellings to 
  262. abuse@gnmidi.com
  263.  
  264. [9] REGISTRATION FORM
  265.  
  266. Fill the registration form from readme.txt 
  267. You can send the form within letter or send it by email (surely not the 
  268. registration fee). If you have no printer then write the information
  269. good readable on paper. 
  270.  
  271. Rules:  When form is correctly filled and registration fee is paid we send the license 
  272.   to the given address. Be sure that your address is correct and good readable, we 
  273.   don't send the disk twice for single payment of shipping costs.
  274. See README.TXT for payment methods.
  275.  
  276. Send the registration fee and the filled registration form to 
  277. =======================
  278. Guenter Nagler
  279. Dr. Robert-Herth Str. 5
  280. A-8120 Peggau
  281. Austria, Oesterreich 
  282. =======================
  283.  
  284. Program and updates can be downloaded from http://www.gnmidi.com
  285.  
  286. [10] CHANGES:
  287.   2.7.1999 started project v1.0
  288.  
  289.   5.8.1999 fixed severe problem in file conversion,
  290.      it is not recommended to use this v1.0 (see disclaimer [4]), 
  291.      please use newer version which has not problem
  292.  
  293.   6.8.1999 v1.01 released
  294.  
  295.   11.9.1999 added generate listing operation
  296.  
  297.   13.9.1999 v1.02 released  
  298.  
  299.   1.10.1999 v1.03 released
  300.       price changed to 12$ or 10 Euro
  301.  
  302.   31.12.1999 price did not change at 31.12.2000, price valid till 30.12.2001
  303.   
  304.   22.1.2000 added some options (link to homepage, link to online order at regsoft.com)
  305.       adapt size of file list at window size changes
  306.  
  307.   24.1.2000 v1.04 released
  308.  
  309.   31.12.2000 price did not change at 31.12.2000, price valid till 30.6.2001
  310.  
  311.   2.1.2001 v1.05 released (no big changes)
  312.  
  313.   30.6.2001 price did not change price valid till 30.12.2001
  314.   30.6.2001 v1.06 released (no big changes)
  315.  
  316.   30.11.2001 price did not change, price valid till 30.12.2002
  317.   30.11.2001 v1.07 released (no big changes, version tested 
  318.     with Windows ME, Windows 2000)
  319.  
  320.   30.11.2001 Windows 98 will not be supported in future, instead program 
  321.               will be tested under Windows ME  
  322.   30.11.2001 Windows NT will not be supported in future, instead program 
  323.               will be tested under Windows 2000
  324.  
  325.   12.5.2002 MIDI compression can be turned off for older keyboards with INI setting
  326.   13.5.2002 C.O.D delivery not supported anymore
  327.   13.5.2002 released 2.08
  328.